home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Languages / Mops 2.7 / README.1ST < prev   
Text File  |  1995-12-20  |  9KB  |  220 lines
  1. This is Mops 2.7, of December 1996.
  2.  
  3. This package contains the full Mops system, but not the manual, which
  4. should be available from the same location you got this.  It should have
  5. a name something like Mops26m.sea.  It's a separate file because of size.
  6.  
  7. Note that there isn't a manual for 2.7 yet.  The current manual is the
  8. 2.6 manual.  The Release Notes (which you should have here) document
  9. the one major new feature.
  10.  
  11.  
  12. You will really need the manual if you're going to do anything with Mops.
  13.  
  14. This package contains the nucleus as an application, and all the source
  15. code.  The nucleus can't be used by itself, but you have to bootstrap
  16. the full system by running the nucleus and using it to compile up everything
  17. else from the source.  The reason for this procedure is to reduce the size 
  18. of the total package as much as possible - it's big enough already!
  19.  
  20. The instructions for compiling up the system are give below, and aren't
  21. hard (I hope).
  22.  
  23.  
  24. A final reminder:  when installing 2.7, if you already have an earlier
  25. Mops version, please remember to remove all copies of the earlier Mops
  26. nucleus.  Otherwise, when you double-click on the new Mops.dic, you'll
  27. probably get the wrong nucleus firing up (and you'll crash immediately).
  28. So trash all copies of your older nucleus, or if you're the cautious type,
  29. save a copy on a floppy and eject it.
  30.  
  31.  
  32.             ============================
  33.  
  34. You should have a folder called "Mops 2.7 system".  In this folder there
  35. should be two files and three folders.  The two files are this file
  36. (README.1ST) and "Mops 2.7 release notes".  The folders are "Mops ƒ",
  37. "Mops Source" and "Quick Edit ƒ".
  38.  
  39. The "release notes" file is mainly aimed at current Mops users, and
  40. describes the differences in this release, as well as possible future
  41. developments.
  42.  
  43. "Mops ƒ" contains:
  44.  
  45. *** The Mops application itself (Mops).
  46.  
  47. *** The source files which get loaded above the nucleus, but before
  48. HFS file handling is available - Base, Args, Class, Struct, String, Files 
  49. and Modules.  These must be in the same folder as Mops.
  50.  
  51.  
  52. "Mops source" contains all the other Mops source files (of course!!)
  53.  
  54. The folder "More classes" contains various ex-Neon classes that I 
  55. have converted, as well as a number of other classes I have written over 
  56. the last few years.  Some of these have not been updated to the latest Mops 
  57. version, but only minor changes would be needed. There is some code there 
  58. which can read and write formatted Microsoft Word documents. I used to need
  59. this capability in my work. By the way, hacking out the MW document format
  60. for versions 1-4 was no joke!!  (Yes, the code will read "fast saved"
  61. documents.)  But I haven't added Word 5 support, and probably won't ever,
  62. since I've now changed over to Nisus (yes, this is now a Microsoft-free
  63. zone).
  64.  
  65. "Quick Edit ƒ" contains Doug Hoffman's Quick Edit text editor which
  66. communicates with Mops via Apple events, and related files.
  67.  
  68. If you don't alter the folder configuration as supplied, things should 
  69. work. If you want to put all the Mops stuff into a folder, or change the 
  70. folder configuration, you will need to edit the file "Mops.paths" in the 
  71. "Mops ƒ" folder - this defines the HFS paths that Mops will use to look for 
  72. files.
  73.  
  74.  
  75.                 ===============================
  76.                 
  77. Now, here are the instructions for compiling everything, to get you up
  78. and running.
  79.  
  80. First start up the nucleus application "Mops".  You should get a window
  81. appearing on the screen with no menus.  The window will be showing a
  82. message telling you that it is only the nucleus, and that you should now
  83. compile the system by typing
  84. load base <ENTER>
  85. and look at the Readme.1st file, or the intro chapter of the manual.
  86. That's exactly what you're doing—so far so good!
  87.  
  88. So go ahead and type
  89.  
  90. load base        (followed by the <ENTER> key)
  91.  
  92. This will do the first stage of the compilation.  Note that Mops commands
  93. are terminated by <ENTER>, AND THAT <ENTER> IS NOT THE SAME AS <RETURN>!
  94. Many Mac programs treat these two keys as equivalent, but Mops doesn't.
  95. Once you've used Mops for a while you'll come to appreciate the usefulness
  96. of this feature.
  97. .
  98. The compilation will take a couple of minutes.  If no errors come up, you'll
  99. get a message saying that interim.dic has been saved, and the ">" prompt
  100. again.
  101.  
  102. interim.dic is the partial dictionary that has just been compiled.  It will
  103. be in the "Mops ƒ" folder.
  104.  
  105. If something goes wrong in the next stages, you can get back to this point
  106. by double-clicking on interim.dic, without having to go back to the bare
  107. nucleus.
  108.  
  109. Now, to compile the rest of the dictionary, type
  110.  
  111. // sys.ld <ENTER>
  112.  
  113. and everything else should be compiled.  It takes about 15 minutes on a
  114. IIsi, so adjust that estimate for whatever Mac you have.  In particular,
  115. when you see "Loading ::Mops source:Module source:xcalls" on the screen
  116. it will appear to do nothing for a long while.  But don't worry, it
  117. should finish eventually.
  118.  
  119. The names of the different files will appear on the screen
  120. as they are being compiled.  If everything goes OK, at the end of the
  121. compilation you'll get the following message, which should be
  122. self-explanatory:
  123.  
  124.   The Mops system is compiled.  Now save the dictionary, by typing e.g.
  125.   save Mops.dic
  126.   then type bye to quit, and after that you'll be able to fire up the
  127.   newly-compiled dictionary.
  128.  
  129. So do what it says—save the full dictionary by typing
  130.  
  131. save Mops.dic <ENTER>
  132.  
  133. In some earlier Mops versions, you could at this point start running the
  134. system.  However we now have a new interface, and this needs to be initialized
  135. properly by being started up from the Finder.  So quit by typing
  136.  
  137. bye <ENTER>
  138.  
  139. Then after that, you can then fire up the "proper" Mops system by
  140. double-clicking on Mops.dic.
  141.  
  142. Finally, if you use floating point, you can compile it by firing up
  143. Mops.dic and typing
  144.  
  145. // floating point <ENTER>
  146.  
  147. and when it's compiled, save with
  148.  
  149. save MopsFP.dic <ENTER>
  150.  
  151. After this, you should be able to fire up either the standard or
  152. floating point system by double-clicking on the dictionary image Mops.dic
  153. or MopsFP.dic.
  154.  
  155.  
  156.                 ================================
  157.  
  158. I assemble the nucleus source with Dave McWherter's shareware McAssembly. I
  159. gather it is reasonably compatible with other Mac assemblers. (Unfortunately,
  160. it doesn't work under System 7.)  So far nobody else has been brave enough
  161. to actually try reassembling the nucleus, as far as I'm aware.  If you find
  162. a bug, it's probably better to simply let me know.
  163.  
  164.  
  165.                 ================================
  166.  
  167.  
  168. Finally, please note that I am releasing all original Mops material into 
  169. the public domain.  If you want to use it commercially, that's fine, go
  170. right ahead, but I'd really appreciate it if you could let me know. In
  171. return I could let you know of any late-breaking bugs/fixes which may be
  172. very helpful to you.  Also, if you want to include Mops in a CD compilation
  173. of shareware/PD material, that's fine, but it would be good if you could
  174. send me a complimentary copy of your CD.
  175.  
  176. I'd also like to know about any other Mops development that anyone feels 
  177. free to let me know about.  Even better, if you develop some whiz-bang new 
  178. class or whatever, you could send me a copy and I could make it part of the
  179. standard Mops release.  This has already occurred with significant code being
  180. contributed by Doug Hoffman, Greg Haverkamp, Xan Gregg and Jay Farrell.  As
  181. a one-man part-time effort, Mops can't hope to compete with the slick commercial
  182. products - but with a bit of cooperation from those using it, Mops could
  183. become a very useful development system, and the price is certainly right.
  184. (So is the performance, I think you'll find.)
  185.  
  186.  
  187. Internet and Web info for Mops
  188. ------------------------------
  189.  
  190. If you have internet access, you'll find Mops discussion in the group
  191. comp.lang.forth.mac.  Feel free to dive in there.  Also note that I
  192. post a FAQ (frequently asked questions) list there every month or so.
  193. See if you can read the latest version of that before emailing me with
  194. a problem, since a lot of questions people ask me are already answered
  195. there.  But feel free to email me with compliments at any time!!!  :-)
  196.  
  197. There's a Mops web page at <URL:http://www.netaxs.com/~jayfar/mops.html>.
  198. This has links to the FAQ and the latest Mops version.
  199.  
  200. For ftp, the latest version should be at:
  201. taygeta.oc.nps.navy.mil, directory  pub/Forth/Mops
  202.  
  203. Finally, if you do have to email me with a problem, remember to tell me
  204. what version you have!
  205.  
  206.  
  207. I hope you enjoy Mops.
  208.  
  209.  
  210. ------------------------------------------------------------------------
  211. Mike Hore            mikeh@zeta.org.au                           _--_|\
  212.                                                                 /      \
  213. snail-mail:                                                     \_.--._x
  214.         Michael Hore                                                  v
  215.         54 Frederick St,
  216.         Sydenham  NSW 2044,
  217.         AUSTRALIA.
  218.  
  219. ------------------------------------------------------------------------
  220.